This document rcntalr; 
GQ'TZRAL (;0!C-'JT5R 
copied, discicsod or u;e; 

GENERAL 


Maria-2 haidv hints 


CONFiPK MTiU ' 

pronns’ir” inforp^slicr! o! the 
COMF?.;,”.'- v,-Vlch may not be 

i o:t:spt e: -udioncci in writing by 


10/03/83 


TMs little OocwTient should help out In converting your programs to work on 
Mari3-2. The main difference tieiween Martas one and two Is that a kernel is no longer 
necessary. Instead, our gi^lcs chip figures out what it Is sifiposed to Pe displaying Dy 
looking at sometNng called, for lack of a oetter term, the display list list (henceforth 
referred to as DLL). This Is, as it sounds, a list telling Maria where our display lists are 
In memory (I know this Is elementary to many of you out i wanted to cover all hasps ) 

In addition this DLL Informs Maria of tne heignt of this zone, whether or not to trigger 
a display list Interrupt (old hat to you 52D0 programmers) ana controlls "holy DMA." 
Detailed discussions of these concedts are availanie In the Tnm wpsthprn Panpn; 
(Random House p^ierbackX — — 

Excerpted from these papers Is the following information; 

DLL format Is as follows: 

<aii> <al2ertaiien,x> <offset -- a oits> 

<c?»i> ~ display list pointer high 

<dpl> — display list pointer low 

Note that registers dpi and dph are no longer needed externally. To avoid confuslOT 
tne pointers to the DLL resides at there previous addresses. If the Oil bit Is set, a 
non-maskable interrupt (NMI) will occur. It is up to the programmer to determine which 
Interrupt just occurred. Al2en should be set If you wish to utilize holy oma for sixteen 
raster zones. When accessing graphics rom while this is set, Marla will "see"' zeros at 
addresses that have both /\15 and A12 set AHwi should be set If you want holy cffna 
for eight line zones. Please note that you really cant use this feature yet, as current 
ram carts go from SflOCO — S8000 or $A000. Because marie elso wants A15 to be high 
for holy dma, graphics must be located above $8000 for eight high zones, and above 
$A000 for Mxteen nigh zones. The moral of this story Is, dont kiss your zeros goodbye 
~ yet New ram cards are in the works. The Offset value is the Zonelength-l. In other 
words put $F here for sixteen high, $7 for eight high, etc. The X is dont care, but 
should probably be zera 

For Marla to know where the Heck DLL Is, you must store its start address In the 
registers OPFL and OPPH. As I mentioned earlier, these reside in the same place the 
late great DPL and OPH lived, "mis only has to be done once at inltlallzalloh. IT IS 
VERY IMPORT/WT THAT TVESE REGISTERS BE STORED BEFORE OMA IS STARTED 
BY STORING TO CTRL. Otherwise things could get messy as maria tries to dma out of 
^ace. 

By the way, our old friend CTRL is a bit different now. Here's the sccep: 

CK DM1 OMO CwrOTH BCNTL KM RMl RMD 

Where: 

Oi Color KllL Makes things go B/w on you A cne here Kills color 

DMn: Cna mode. Explained below. 

CWIDTH A zero mesis one byte characters, a one means twa 

BCNTL; Border control, one means bleed the backgrouno color to the edge 
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Kangaroo mode. A one turns off transparency. Useful for 320x2 mode. 
Read mode. Inuerted from Maria cne. 


Oil otio tteanlng 
0 0 rest A 

0 1 Test B 

1 0 Run norirally 

1 1 Inactive 


Rfll RtiO neanlno 
1 1 320A 

1 0 3200 

D 1 Reserved 

0 0 160x2 or 160x4 


Tne test modes should never be invoked, as your 6502 will get very confu»d when 
its address lines start going all over the plaoe without the HALT line asserted airing 
DMA Only use Uie 1 0 or 1 1. 

1 reiterate the initial value of CTRL must be stored AfTER DPPH and DPPL 
have been set 14). Additionally, you snould do all of your other initialization first, wait 
for vblank to start, and then store Sao or whatever to CTRL. 


Display list neaders have cnangea once again. There are two forms that they may 
assume — the short (1040 EZ) and the long (1040> 

Shorty: < ppl > — low address of gr^ics referenced 

< w > — width - <P P P> <W W w w w> 


< pph > — nigh pointer to graphics 

< npQS> — you guessed it — horizontal position 

The short header Is used only for direct mode graphics. Note also that we now 
have a full five bits of width (this ^lies also to character maps). You might ask, 
"whatever happened to the indirect bit?" well Virginia, nere comes the five byte header. 

< ppl > 

< wl > — <wm> <1> <ind> <0 G a 0 0> 


< hpos> 

wm - the new value of the write mode from now cxx -r, \ 

ind - indirect mode for this header only. ^ 

As ’ ual, DMA is ended by a neacer with a second byte of zero. An amusing side 
effect of this with the five byte header is that a value of zero in the < w > byte will 
give you a thirty-two byte wide objecL The long header Is used to change tne write 
mode, for thirty-two wide cajects, and for all character map headers. 

Maria starts DMAdng out of your DLL on the (I believe) I6th line after vsync. This 
Is a quite a few casters before the visible screen known and loved by all. AddUonally, 
Marla stops reading on the 258th raster ~ some time after our regulation (192) sized 
screen ends. This leaves 50 rasters to be will between the top aid bottom of the 
screea CS.L elements must be In place for tnis space, probably pointing to a couple of 
zeros so not muon DMA will happen. Note that these DLL spots are a good place to put 
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a couple of DLIs — for vblank ana top of scre^ type stuff. Some stanoaro snouia be 
set for now many lines go aoove ana below tre visible screw. For now. I'm splitting the 
leftovers evenly with 25 acove ana below. 

other than these details, much remains the same. The only other changes are: 

You no longer have to convert the graphics to wlerd bit patterns 

The msRory map has changed somewhat. See the attacheo chart for aetalls. 


Disco boogie gll down! Have fun programming the most awesome game matailne In 
history! 

-kevino 


3600 MODE MEflORY MAP 
{1702 version) 




